home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 430 / applic / catfile.doc < prev    next >
Text File  |  1989-11-16  |  4KB  |  80 lines
  1. CATFILE DESCRIPTION:
  2. Catfile is a program that will catalog a disk and put it into a 
  3. format that compatible with the database program First Base. 
  4. Catfile searches through all directories on the disk for file 
  5. names with extenders that you specify. The names of these files, 
  6. sizes, extenders along with a number of blank spaces is written 
  7. to a file.
  8.  
  9. The program is most useful with two disk drives. The disks to be 
  10. cataloged are placed in drive A. The disk with the file to be 
  11. written to is placed in drive B. It is best to give your disks 
  12. some short identifier such as a 3 digit number. This will be 
  13. recorded with each file saved. The blank spaces mentioned above 
  14. are for a description of the file. This can be typed in from the 
  15. First Base program after you have completed making the file.
  16.  
  17. CONFIGURATION FILE:
  18. A configuration file is used to specify what data about files are 
  19. to be included and in what order to save it. Before you run the 
  20. program you must define the configuration file, or you can use 
  21. the sample supplied with this program. The configuration file is 
  22. named CATFILE.CFG. The only significant data in this file are the 
  23. numbers from 1 through 7 located in the left hand column of the 
  24. file. The sample included file also has a description of each 
  25. numbered field. This remarks are optional.
  26.  
  27. The meaning of the numbers is as follows: 1 is the file name (8 
  28. spaces); 2 is the file name extender (3 spaces); 3 is the file's 
  29. year month and day (6 spaces); 4 is the file's size (6 spaces); 5 
  30. is disk identifier that you type in (3 spaces); 6 is a blank 
  31. field (26 spaces); 7 is a blank field (1 space). Fields 6 and 7 
  32. are for later entry of data using the First Base database 
  33. program. Field 7 could also be used to add an extra space between 
  34. fields. The field numbers may be repeated within the .CFG file or 
  35. they may be put in any order but the maximum number of lines 
  36. permitted is 7. The minimum number is 1.
  37.  
  38. In order to make the .CFG file you must use some kind of an 
  39. editor. I used the editor in the program Flash to make the 
  40. included sample. 
  41.  
  42.  
  43. RUNNING CATFILE:
  44. To run the program put a disk containing CATFILE.PRG into drive A 
  45. and double click on the name or icon. When the program begins you 
  46. may enter up to 20 different extenders. When this is done only 
  47. file names with these extenders will be saved to drive B. This 
  48. makes it possible, for instance, to save only programs by typing 
  49. in .PRG, .TTP, and .TOS. There are many other applications. If 
  50. you want all files on the disk listed you use the familiar *. 
  51. After each extender or * type return. When finished use the 
  52. escape key. A file selector box appears for drive B. Choose a 
  53. name for your data file, it normally should be one that ends in 
  54. .DAT if it is to be used with the First Base Program. Then all 
  55. you have to do is to put your disks into drive A one at a time, 
  56. type in the disk number, and the computer does the rest. When you 
  57. have finished the last disk instead of entering a disk number 
  58. press the escape key and the program will terminate.
  59.  
  60. MAKING A DEFINITION FILE:
  61. To use the file that you have created with the First Base program 
  62. you will need a .DEF file. If you used the sample CATFILE.CFG 
  63. supplied then use the DATAFILE.DEF file. First make a copy of the 
  64. DATAFILE.DEF. Then rename the copy to whatever you called your  
  65. file containing the file names but using the extender .DEF instead  
  66. of .DAT. You then can run the First Base program to view the data.
  67.  
  68. If you created a new CATFILE.CFG file with an editor or word 
  69. processor you will have to create a .DEF file using the same 
  70. editor. The .DEF file is explained in the First Base text file. 
  71. Following the : for each field in the DEF file there are a number 
  72. of underlines. You need to include the proper number for each 
  73. field as described in the configuration file description above. 
  74. For instance if you have FILE NAME: ________ you must put in 8 
  75. underlines. This insures the data columns will be read correctly 
  76. in First Base. If the fields are split between boxes in First 
  77. Base you probably have not set up the .DEF file properly.
  78.  
  79. Dave Henry
  80.